Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / SV30I.ZIP;1 / SV.HLP < prev

Wrap

Text File | 1993-04-02 | 44.4 KB | 1,243 lines

…ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕª ∫ Source View Version 3.0 ∫ ∫ Reference Manual ∫ ∫ April, 1992 ∫ »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕº Introduction ﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂ ˇ Source View is a DOS programming environment designed for Command-Line-Compilers such as: MASM, TASM, OPTASM, TPC, TCC, MicroSoft Fortran, MicroSoft Cobol, etc. It provides a Multi-file Multi-screen Editor, a Compiler and Batch File Execution Interface, a DOS Command Interface, and a unique Run-time File Access Interface. It can greatly improve the productivity of the programmer and those compilers it associated with. If you find Source View powerful, efficient and easy to use, a $30 contribution will be appreciated. For an additional $10, you will receive the next version of the software when it is available. Please send check or money order to: Michael W. Chen 11309 Elmcrest Street El Monte, CA 91732 ˇ Goodies Highlight ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ Source View implements over one hundred editing, compiling, and file managing features. These are just some of the most unique and powerful ones the that you must know: ˛ Memory Efficiency Source View occupies only 22 KB of memory at run time. You can even load Source View high to achieve the best memory efficiency. ˛ Run-time File Access This interface allows your compiler to access files opened by the Source View Editor. It truly joins a compiler into a editing, compiling and file managing working environment. This is a powerful feature that other stand-alone editors do not have. ˛ Execution Interface You can execute DOS commands and other programs including batch files within Source View. By assigning "Compiler" and "Batch", you can execute your favorite programs in a single keystroke. ˛ Multiple Files Opening The Source View Editor allows you to open a series of files using wild cards and multiple file specification. ˛ Inter-file Find/Replace Find or replace text in all files opened by the Source View Editor, good for making global changes in different modules. ˛ Split Windows Allows you to view and edit two different areas of the same file simultaneously, extremely useful for editing large files. ˛ Display Resolution The Source View Editor supports the following wide range of text display resolution: 80x25, 80x33, 80x40, 80x50, 132x25, 132x33, 132x40, 132x50. ˛ View and Go By using both View Main Screen and Go to Line Number function, you can look at the compiler's error messages and quickly move to the error line. ˛ Open Duplicate File Wanted to see what the file used to look like after millions of changes? Just open the old file once again, and it will be set to Read-Only to prevent modification. ˛ Frame Character Set Never able to remember frame characters' ASCII codes? Select and enable the Frame Character Set, and numeric keys will be translated into frame characters. Section 1 - Main Menu ﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂ ˇ The Source View Main Menu is displayed at the top of the screen and is divided into multiple menu functions. You can move the select bar between functions by pressing the Left or Right arrow key. To invoke the selected function, press the Enter key, the Down arrow key, or the highlighted letter of the function name. If the function is a secondary menu, it will replace the main menu with its name displayed on the left. To exit a secondary menu, press the Esc key or the Up arrow key. If the Esc key is pressed in the main menu, the display screen will be cleared. ˇ File Menu ÕÕÕÕÕÕÕÕÕ This menu is an interface to the DOS command interpreter COMMAND.COM. All commands must use the formats DOS requires. The Dir, Copy, and Del functions are equal to those DOS commands that of the same names. The followings are other available functions. Function Description ƒƒƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ Rename Renames DOS file(s) or moves a file from one directory to another on the same device. When you attempt to move a file, make sure to end the target directory with a back slash. For example: Rename c:\compile.bat c:\asm\ Rename ..\project.pas .\ Print Prints a file to the Standard Print Device. Execute Executes a DOS executable file. It can be a DOS batch file, an EXE file or a COM file. DOShell Accesses the DOS Command Interpreter Shell. Command Executes a DOS command. Info Lists a series of file and system related information including files opened in the Source View Editor, current path, and system free memory. ˇ Edit ÕÕÕÕ This function enters the Source View Multi-file Multi-screen Editor. If it is the first time entering the Editor, you will be prompted to enter file name. If you specified file name(s) when you run Source View, you can enter the editor directly. For example: SV readme.doc SV c:\asm\*.asm, a:sys*.pas, hello.c Notice that multiple files and wild cards are accepted. See Section 2 for a complete reference on all editing functions. ˇ Compile Menu ÕÕÕÕÕÕÕÕÕÕÕÕ This menu provides access to the Source View Compiler and Batch File Execution Interface. Function Description ƒƒƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ Compile Executes the command line specified in the "Assign" compiler function. Batch Executes the command line specified in the "Assign" batch file function. Assign Assigns two command lines that execute your compiler and batch file. For example: masm master.asm c:\turbo\build project.pas There is no restriction on what kind of file you can assign as a "compiler" or a "batch file." It can be a DOS batch file, an EXE file or a COM file. If the file is not found in the specified drive or directory during execution, the Source View Execution Interface will search the current DOS Path for the file and execute it when found. Run Runs a program. If the Run-time File Access Interface is enabled, all files executed from this menu will be able to access files that are opened by the Source View Editor. ˇ Help Menu ÕÕÕÕÕÕÕÕÕ This menu is a topic driven help facility. It covers most of the functions and useful tips in Source View. You can move the highlight bar to select a topic. Press the Enter key to display the help message. The Help Menu requires two files in the original directory from which Source View was executed: SV.COM and SV.HLP. File SV.HLP is a complete reference of the Source View program and can be opened by the Source View Editor or printed directly as text file. ˇ Quit ÕÕÕÕ Exits Source View. You will be asked to confirm quitting Source View. Press 'Y' to confirm. If there are files in the Source View Editor that have not been saved, you will be asked whether you wanted to save them or not. Press 'Y' to confirm. ˇ Setup Menu ÕÕÕÕÕÕÕÕÕÕ See Section 4 - Setup for details. Section 2 - Source View Editor ﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂ ˇ The Source View Multi-file Multi-screen Editor implements over ninety powerful and easy-to-use editing functions. There are two keyboard assignments for each editing function. The first one is the system assignment that uses only control keys and can not be redefined by users. The second one is the user assignment that uses only function keys and can be customized by in Key Map Setup. For a quick reference on both keyboard assignments, press Ctrl_QH in the Source View Editor. The followings are detail descriptions for each editing function that divided into eight categories. The name of each function is followed by its system keyboard assignment enclosed by a pair of brackets. ˇ Cursor Movement ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Move Left [Ctrl S] Moves cursor to the left one column. ˛ Move Right [Ctrl D] Moves cursor to the right one column. ˛ Move Up [Ctrl E] Moves cursor up one line. ˛ Move Down [Ctrl X] Moves cursor down one line. ˛ Page Up [Ctrl R] Moves cursor up one page. ˛ Page Down [Ctrl C] Moves cursor down one page. ˛ Move Left One Word [Ctrl A] Moves cursor to the beginning of the word on the left. The Source View Editor recognizes a WORD as a character string separated by one of the Non-text Characters. You can change the default Non-text Character Set in Editor Setup. Space and TAB are always considered to be Non- text Characters. ˛ Move Right One Word [Ctrl F] Moves cursor to the beginning of the word on the right. ˛ Scroll Up [Ctrl W] Scrolls current page up one line while cursor stays at the same line. ˛ Scroll Down [Ctrl Z] Scrolls current page down one line while cursor stays at the same line. ˛ Quick Key [Ctrl Q] This key is a preceding key used in conjunction with a secondary key to invoke a set of editing functions. ˛ Top of File [Ctrl Q R] Moves cursor to the beginning of the file. ˛ Bottom of File [Ctrl Q C] Moves cursor to the end of the file. ˛ Go to Begin of Line [Ctrl Q S] Moves cursor to the beginning of the line. ˛ Go to End of Line [Ctrl Q D] Moves cursor to the end of the line. If the Trim Mode is on and the file was modified, trailing spaces will be deleted. ˛ Top of Page [Ctrl Q E] Moves cursor to the first line of current page. ˛ Bottom of Page [Ctrl Q X] Moves cursor to the last line of current page. ˇ Default Edit Mode ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Option Key [Ctrl O] This key is a preceding key used in conjunction with a secondary key to invoke a set of editing functions. ˛ Insert Mode [Ctrl V] Turns on/off character Insert Mode. If Insert Mode is on, new characters are inserted in front of cursor. If Insert Mode is off, new characters are typed over old characters. Insert Mode also affects cursor appearance and some editing functions such as Erase Left Character [Backspace] and Delete Character [Ctrl G]. ˛ Indent Mode [Ctrl O I] Turns on/off Indent Mode. If Indent Mode is on, the first non-space character in a new line will be aligned with the first non-space character of the previous line. Indent Mode also affects Insert New Line [Ctrl N] and End of Current Line [Ctrl M] or [Enter]. ˛ Tab Mode [Ctrl O T] Turns on/off Tab Mode. If Tab Mode is on, the Source View Editor will try to convert leading spaces into TAB characters to reduce file size. Tab Mode also affects Tab to the Right [Ctrl I] and Tab to the Left [Ctrl Q I]. ˛ Trim Mode [Ctrl O R] Turns on/off Trim Mode. If Trim Mode is on and the file has been modified, trailing spaces will be deleted after cursor is moved away from current line. ˛ Wrap Mode [Ctrl O W] Turns on/off Wrap Mode. If Wrap Mode is on and the Auto- Wrap Margin is set, pressing space bar at any positions beyond the Auto-wrap Right Margin will cause current line to be formatted. See Format Line [Ctrl B] for more on line formatting. ˛ Auto-wrap Margins [Ctrl O M] Enters the Auto-wrap Right and Left Margins. The right margin must be greater than 8 and less than 32768. The left margin must be less than the right margin by 8. See Format Line [Ctrl B] for more on line formatting. ˇ Insert and Delete ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Delete Character [Ctrl G] Deletes the character at cursor position. If cursor is at the end of the line and Insert Mode is on, the next line will be appended to the end of current line at cursor position. ˛ Erase Left Character [Ctrl H] or [Backspace] Erases the character in front of cursor. If cursor is at the beginning of the line and Insert Mode is on, current line will be appended to the end of previous line. ˛ Tab to the Right [Ctrl I] or [Tab] If both Tab Mode and Insert Mode is on, a TAB character is inserted, and cursor jumps to the next tab position on the right. If Tab Mode is off but Insert Mode is on, Space characters are inserted from current position to the next tab position. If Insert Mode is off, no character is inserted, and yet cursor jumps to the next tab position on the right. The tab size used in the Source View Editor is eight. ˛ Insert New Line [Ctrl N] If Insert Mode is on, a new line is inserted ahead of the current line. If Indent Mode is also on, cursor will be placed at the same position of the first non-space character of the current line. ˛ Delete Right Word [Ctrl T] Deletes the word starts from cursor position. If cursor is pointing at a space, all consecutive spaces are deleted. If cursor is pointing at a Non-text Character other than space, all consecutive Non-text Characters are deleted. If cursor is at the end of the line and Insert Mode is on, the next line will be appended to the end of current line at cursor position. ˛ Delete Current Line [Ctrl Y] Deletes the line at cursor position and moves cursor back to the beginning of the line. ˛ Erase to End of Line [Ctrl Q Y] Erases all characters start from cursor position to the end of current line. ˛ Tab to the Left [Ctrl Q I] If Insert Mode is on, all characters from cursor position to the previous tab position to the left are deleted. If Insert Mode is off, then no character is deleted, and yet cursor jumps to the previous tab position on the left. By default, this function is assigned to [Shift Tab] in the user keyboard assignment. ˛ End of Current Line [Ctrl M] or [Enter] Inserts a pair of Carriage-Return and Line-Feed in cursor position to open a new line. If Indent Mode is on, cursor will be placed at the same position of the first non-space character of the previous line. ˛ Delete Left Word [Ctrl Backspace] Deletes all characters start from cursor position to the beginning of the word on the left. The system keyboard assignment [Ctrl Backspace] is equal to control character DEL (ASCII 127). In the PC character set, it is displayed as ''. If you want to enter this as a text character, you can use Control Character Prefix [Ctrl P]. ˇ Block Processing ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ The Source View Editor can mark one text block for each opened file, but there is only one text block among all files can be highlighted in any given time. A highlighted text block is called the active text block. Most Block Processing functions can only be done to the active text block. ˛ Block Key [Ctrl K] This key is a preceding key used in conjunction with a secondary key to invoke a set of editing functions. ˛ Mark Begin of Block [Ctrl K B] Marks the beginning of a text block. If the End of Block was marked behind current position, the text block will be highlighted and becomes the active text block. ˛ Mark End of Block [Ctrl K K] Marks the end of a text block. If the Begin of Block was marked ahead of current position, the text block will be highlighted and becomes the active text block. ˛ Copy Active block [Ctrl K C] Copies the active text block to current position. If current position is inside the active text block, no action will be taken. If the active text block was in another file, the text block in that file will be disabled after copying. ˛ Move Active block [Ctrl K V] Moves the active text block to current position. If current position is inside the active text block, no action will be taken. If the active text block was in another file, the text block in that file will be deleted after moving. ˛ Go to Begin of Block [Ctrl Q B] Moves cursor to the position marked by Mark Begin of Block [Ctrl K B] in current file. ˛ Go to End of Block [Ctrl Q K] Moves cursor to the position marked by Mark End of Block [Ctrl K B] in current file. ˛ Mark Current Line [Ctrl K L] Marks current line including its Carriage-Return and Line-Feed characters as the active text block. Cursor will move back to the beginning of current line. This function is useful for moving or copying a line. ˛ Mark Current Word [Ctrl K T] Marks current word as the active text block. Cursor will move to the end of the marked word. This function is useful for moving or copying a word. ˛ Hide/Reveal Block [Ctrl K H] Disables or enables the text block in current file as the active text block. ˛ Print Block/File [Ctrl K P] Prints the active text block, if it's in current file, to the default printer device. If the active text block is not in current file, the entire file is printed. ˛ Read Block from File [Ctrl K R] Reads a file into current position and marks it as the active text block. ˛ Write Block to File [Ctrl K W] Writes the active text block, if it's in current file, to a file. If the file name you specified already exists, you have to confirm whether to overwrite it or not. ˛ Delete Block [Ctrl K Y] Deletes the active text block if it's in current file. The End of Block mark will be assigned to the same position of the Begin of Block mark. ˛ Shift Block Left [Ctrl K [] If the active text block is in current file, all lines with leading space(s) in the active text block are shifted to the left. This function is useful for aligning a set of language statements with others. For example, if you deleted a pair of BEGIN and END in a Pascal program, you can use this function to make all statements between them align correctly with other statements. ˛ Shift Block Right [Ctrl K ]] If the active text block is in current file, all lines in the active text block are shifted to the right by adding one leading space. This function does the opposite of Shift Block Left [Ctrl K []. ˇ Find/Replace ÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Find Text String [Ctrl Q F] Finds a text string in current or all files. First, enter the target string. Then enter search options. See Do with New Options [Ctrl O L] for details on how to apply search options. If the string is found, cursor will point at the string. If the string is not found, an error message will be displayed and cursor will not move. ˛ Replace Text String [Ctrl Q A] Finds a text string in current or all files and replaces it with a new string. First, enter the target string. Then enter new string and finally search options. See Do with New Options [Ctrl O L] for details on search options. ˛ Find/Replace Again [Ctrl L] Repeats the last Find or Replace operation. ˛ Do with New Options [Ctrl O L] Enters new search options, then repeat the last Find or Replace operation. The followings are all available search options. Note that options can be entered consecutively without any other characters. Option Description ƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ G Global search. Search the entire file for the target string. If the 'B' option is used, the search starts at the end of the file. Otherwise, it starts from the top of the file. C By default, the target string search ignores character case. Use this option to make it to be case sensitive. You can also change the default to case sensitive in Editor Setup. Then the 'U' option will appear in the option entering prompt as (GUBWKIAN) instead of (GCBWKIAN). U If by default the string search is case sensitive, you can use this option to force it to ignore case. B Perform a backward search. W Qualify the target string only if both its preceding and succeeding characters are Non- text Characters. K If the active text block is in current file, the search will be restricted within the text block only. This option will be ignored if option 'I' or 'G' is used. I Inter-file search. Search all files in the Source View Editor for the target string. This is one of the most useful and powerful functions for editing multiple program modules. A Replace all target string occurrences. This option applies to Replace operation only. N No confirming when replacing target string. This option applies to Replace operation only. nnnnn A number range from 1 to 65535. If it is a Find operation, the search will not stop until these many occurrences have passed. If it is a Replace operation, the search and replace will continue for these many times. ˇ File Management ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Open New File(s) [Ctrl K O] Opens one or more files into the Source View Editor. Multiple files or wild cards are accepted. For example: readme.doc c:\asm\*.asm, a:sys*.pas, hello.c If a user attempts to open a duplicate file, a warning will be displayed and the new file will be set to read- only. All modification will be ignored. ˛ Save Current File [Ctrl K S] Saves current file to its original drive and directory. If the Backup Source Files switch is set on, the original file will be renamed to its backup format. If the Backup Source Files switch is set off, the original file will be overwritten. If the original file bares a read-only attribute, the user will be prompted to confirm a forced operation. If the user does confirm override, the newly created file will retain the read-only attribute. A backup file name is formed by adding a dollar sign '$' to the end of the extension of the original file. ˛ Save File as [Ctrl K A] Saves current file to a new location with a new file name. If you only specify drive or directory, current file will be saved to that location with the same file name. The Backup Source Files switch also applies to this function. ˛ Previous File [Ctrl [] Jumps to the previous file opened in the Source View Editor. ˛ Next File [Ctrl ]] Jumps to the next file opened in the Source View Editor. ˛ Close File [Ctrl K Z] Closes current file. If current file has been modified, you have to confirm whether to save it or not. ˛ Compile [Ctrl Q O] Invokes the "Compile" function in the Compile Menu. ˛ Batch [Ctrl Q T] Invokes the "Batch" function in the Compile Menu. ˛ Rename Current File [Ctrl O N] Renames current file, including its drive and directory. If a user attempts to use a duplicate file name, the function will be denied. ˛ Save All Files [Ctrl O S] Saves all files in the Source View Editor to its original drive and directory. You have to confirm to save only those modified files or to save all file regardless. ˛ Exit [Ctrl K X] Exits Source View. If there are modified files, you have to confirm whether to save them or not. ˇ Window Management ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Window Key [Ctrl J] This key is a preceding key used in conjunction with a secondary key to invoke a set of editing functions. ˛ Zoom/Unzoom Display [Ctrl \] Turns on/off zoom display mode. In zoom display mode all files occupy the entire display screen. ˛ Cascade Windows [Ctrl J C] Formats all file windows into a cascade style. Each file occupies a 60x12 window partially overlaying one another. If there are only two files opened, Dual Windows format will be used. ˛ Dual Windows [Ctrl J D] Formats all file windows into a double window style. Each file occupies either the upper window or the lower window. If there is only one file opened, no action will be taken. ˛ Tile Windows [Ctrl J T] Formats all file windows into a tile style. Each file occupies one of the four windows on the screen. If there are less than four files are opened, other window formats such as format number 3 or 2 will be used. ˛ Window Format [Ctrl J F] Formats all file windows into one of the six windowing styles listed below. Format Description ƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ 0 Cascade windows [Ctrl J C]. 1 Vertical dual windows. 2 Horizontal dual windows [Ctrl J D]. 3 Horizontal triple windows, one large upper window and two small lower windows. 4 Tile windows [Ctrl J T]. 5 Vertical triple windows, one large left window and two small right windows. ˛ Move/Size Window [Ctrl J M] Moves the location or adjusts the size of current window. Press the four arrow keys the move the window. Press the four arrow keys while holding down the Shift key to adjust the size of the window. If there is only one file opened, no action will be taken. ˛ Refresh Display [Ctrl J R] Clears screen and refreshes all file windows. ˛ Horizontal Split [Ctrl J H] Splits the file window horizontally into two windows. Split window is a very useful feature, especially for big source file editing. It allows you to see two different areas of the same file simultaneously. Invoke this function the second time will turn off window splitting. Use Change Split Window [Ctrl _] to jump between two split windows. ˛ Vertical Split [Ctrl J V] Splits the file window vertically into two windows. This is an alternative way to split a file window. Invoke this function the second time will turn off window splitting. Use Change Split Window [Ctrl _] to jump between two split windows. ˛ Change Split Window [Ctrl _] Changes current editing (cursor) position between the two split windows. If current window is not split, no action will be taken. Since the Minus sign and the Underscore sign are on the same key, this control key can also be pressed as [Ctrl -]. ˛ Go to Window(1-0) [Ctrl J 1..0] Goes to one of the first ten opened file windows. The Source View Editor assigns the first ten files with window numbers 1 to 0, and it's displayed in front of the file name on the status line of its file window. ˛ Go to File Window [Ctrl J G] Goes to a file window by selecting the name of that file. Press the arrow keys to browse through file names, and press the ENTER key to select. ˇ Miscellaneous ÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Assign Macro [Ctrl @] Assigns a keystroke macro. A keystroke macro is a number of keystrokes memorize by the editor and can be later executed by Execute Macro [Ctrl ^]. During the macro assignment, all interactive portions, such as entering a file name or replying to a question, will not be included in the keystroke macro. To end a macro assignment, press [Ctrl @] again. The maximum number of keystrokes in a macro is 64. The keystroke macro is saved along with the system setup file. ˛ Execute Macro [Ctrl ^] Executes the assigned keystroke macro. ˛ Repeat Macro [Ctrl Q ^] Executes the assigned keystroke macro for a specific number of times. ˛ Control Code Prefix [Ctrl P] This function allows you to insert one of the 33 control characters (ASCII 0-31, 127) into the document. First, press [Ctrl P], then press the control key associated with the control character. For example, press [Ctrl P] then press the left bracket '[' will generate control character ESCape. While entering the control character, it is optional to hold down the Control key. However, to enter control character DEL (ASCII 127), you have to hold down the Control key and press Backspace. ˛ Format Line [Ctrl B] If Wrap Mode is on, current line will be formatted according to the Auto-wrap Right and Left Margins. If current line is beyond the right margin, exceeding words will be pushed to the next line. If current line is within the right margin, extra words will be brought up from the next line. Then extra spaces will be inserted until the last character of the line reaches the right margin. If Wrap Mode is off, no action will be taken. By pressing space bar at any position beyond the Auto- wrap Right Margin will also cause current line to be formatted. After current line is formatted, cursor will move to the left margin of the next line, but if line formatting is invoked by space bar, cursor will retain its editing position. If current line is null, or the next line is the beginning of a new paragraph, line formatting will not occur, yet cursor will move to the left margin of the next line. By using left margin, line formatting allows you to edit paragraphs just like all of these that you now are reading. It maintains a indent space on the left, while still keeping a perfect alignment on the right edge. ˛ Go to Line Number [Ctrl Q G] Moves cursor to a specific number of line. ˛ Restore Line [Ctrl Q L] Restores current line to its original form. If a number of modifications have been made to current line, and cursor has not yet been moved to another line, this function gives you a chance to discard all modifications. Most of the functions in Block Processing, File Management, Window Management, and Miscellaneous categories force users to commit changes made to current line. Therefore, after invoking these functions, Restore Line will have no effect. ˛ Go to Last Position [Ctrl Q P] Moves cursor back to the previous position. This function is very useful for recurring after some functions such as Find/Replace Text String. It allows you to quickly go back to the position where you invoke the previous function. ˛ View Main Screen [Ctrl Q V] Swaps current display to the main screen where all the compiling, file execution, and other DOS activities take place. This is a useful feature for programmers to view error messages produced by the compiler while correcting them in the Source View Editor. Press another key to swap back to the Source View Editor screen. ˛ Lower Case Word [Ctrl Q Z] Turns current word into its lower case and moves cursor to the beginning of the next word. ˛ Upper Case Word [Ctrl Q W] Turns current word into its upper case and moves cursor to the beginning of the next word. ˛ Mark Position (1-4) [Ctrl K 1..4] Marks current cursor position as one of the four positions (book marks) that can later return to by the Go to Position (1-4) function. There are four book marks for each file opened by the Source View Editor. ˛ Go to Position (1-4) [Ctrl Q 1..4] Moves cursor to one of the four positions marked the Mark Position (1-4) function. ˛ Exit to Main Menu [Ctrl K D] Exits to main menu. All files opened by the Source View Editor are still ON-LINE. If you reenter the Source View Editor by pressing 'E' at the main menu, you will find that they are still active, and those have been modified still need to be saved. ˛ Help [Ctrl Q H] Enters this topic driven help facility. It covers all editing functions in the Source View Editor. You can move the highlight bar to select a topic. Press the Enter key to display the help message. This function requires two files in the original directory from which Source View was executed: SV.COM and SV.HLP. File SV.HLP is a complete reference of the Source View program and can be opened by the Source View Editor or printed directly as text file. ˛ Frame Character Set [Ctrl O F] Select one out of four character sets for drawing frames in the Source View Editor. If a frame character set other than zero is selected, the fifth character of in the set (the cross character) will be displayed in the lower right corner of the screen, and numeric characters '0' to '9' and '-' will be translated into frame characters as the following diagram: (Notice that the formation of characters '1' to '9' resembles their positions in the numeric keypad.) 7 8 9 7 8 9 ⁄ ¬ ø … À ª ≥0 ∫0 4√ ≈5 ¥6 4Ã Œ5 π6 ƒ - Õ - ¿ ¡ Ÿ » º 1 2 3 1 2 3 (Frame Set #1) (Frame Set #2) 7 8 9 7 8 9 ÷ “ ∑ ’ — ∏ ∫0 ≥0 4« ◊5 ∂6 4Δ ÿ5 µ6 Õ - ƒ - ” – Ω ‘ œ æ 1 2 3 1 2 3 (Frame Set #3) (Frame Set #4) If zero is selected, numeric characters will be used as normal characters. ˛ Display Resolution [Ctrl O D] Selects text screen display resolution. The Source View Editor supports over 8 different display resolutions: Resolution EGA VGA VGA132 ƒƒƒƒƒƒƒƒƒƒ ƒƒƒƒƒ ƒƒƒƒƒ ƒƒƒƒƒƒ 0 80x25 80x25 132x25 1 80x29 80x33 132x33 2 80x35 80x40 132x40 3 80x43 80x50 132x50 80 80x(?) 80x(?) N/A 132 N/A N/A 132x(?) (?) Selecting 80 or 132 column mode will only change the horizontal display width. The vertical display length depends on current resolution number (0-3). Some VGA adapters may be capable of achieving 132x60 display mode. Since there is no standard for VGA 132 column mode, you have to assign the video BIOS mode in System Setup according to the VGA adapter you are using. The default VGA 132 mode is set to support Western Digital chip set, Paradise VGA Card. The following is a list of VGA Cards and their proper 132 column mode (in decimal): VGA Adapter 132x25 Mode ƒƒƒƒƒƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ Paradise VGA 85 Trident TVGA 84 ATI VGA Wonder 35 Orchid Fahrenheit 85 STB PowerGraph 53 Diamond Stealth/SpeedStar 85 Genoa 20 Some VGA adapters, such as Video-7, use non-standard video mode setting routine for 132 column mode. Their 132 column modes are not supported by this function. *** WARNING *** If you are running Windows 3.x Enhance Mode and opened Source View in a window instead of full screen, DO NOT select 132 column mode. If you do that, Windows will force you to close Source View immediately. Section 3 - Run-time File Access Interface ﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂ ˇ The Run-time File Access Interface allows programs that executed by the Source View Execution Interface to access all files that are loaded into the Source View Editor. These programs can be of those executed by the "Compile", "Batch", and "Run" function in the Compile Menu. For example, you execute a compiler from Source View. When the compiler attempts to access files that are currently loaded in the Source View Editor, the interface overrides DOS and provides file I/O functions to the compiler. Even if you did not save your modified files before compiling, the compiler will still read the most recent version of your source files. *** WARNING *** When this interface is active, DO NOT run any programs that might hang your computer without saving your files. If the program halts the computer, all files that modified in the Source View Editor will be permanently lost. This interface is layered upon the DOS system function call (Interrupt 21h). The DOS functions it supports are: Open file handle (AH=3dh AL=0), Read file handle (AH=3fh), Close file handle (AH=3eh), Seek file (AH=42h), File I/O control (AH=44h AL=0,6,7), Get file attribute (AH=43h AL=0), Get file date/time (AH=57h), Find first (AH=4eh), Find next (AH=4fh). Programs are not allowed to make any kind of modification to all files in the Source View Editor. Therefore, the following set of DOS function calls to those files will fail and a DOS Error Code Number 5 (Access denied) will be returned: Open file handle (AH=3dh AL=1,2), Write file handle (AH=40h), File I/O control (AH=44h AL=1,2,3,4,5,8,9), Set file attribute (AH=43h AL=1). The Source View Editor keeps track of the date and time of its file modification. Therefore, if DOS function Get file date/time (AH=57) is called by a child program, the last modification date and time of the file is returned. This allows those file date and time oriented programs, such as Make utility, execute correctly. The maximum number of files this interface can open at the time is 32, and it is also subject to the number of files that current DOS environment allows. This feature can be turned off and on from the System Setup function. Section 4 - Setup ﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂﬂ ˇ The Setup Menu allows users to customize the system to meet their own programming style and environment preference. There are five different types of setup: Setup Type Instruction ƒƒƒƒƒƒƒƒƒƒ ƒƒƒƒƒƒƒƒƒƒƒ [Color] Press the Left/Right arrow key to change foreground color and the Up/ Down arrow key to change background color. Press the Enter key to accept the setting. [Switch] Press the Enter key to turn on/off the switch. [Number] Enter a decimal number. If the applied number exceeds the expected range of the setup item, it will not be accepted. [String] Enter a file name, a command line, or a character set. [Function Key] Press the desired function key that you want to assign to that editing function. If the key has already been assigned to another function, an error message is displayed. To remove a key assignment, press the Space Bar. The Setup Menu requires file SV.COM in the original directory from which Source View was executed. ˇ System Setup Menu ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Menu Text Color [Color] Display color for normal text in the main menu. ˛ Highlight Text Color [Color] Display color for key letters in the main menu. ˛ Select Bar Color [Color] Display color for menu select bar. ˛ Run-time File Access [Switch] Turns on/off the Run-time File Access feature. If this switch is off, you have to save all of you modified files before you do any compiling work. If this switch is on, all files in the Source View Editor are accessible to you compiler. ˛ Interrupt 2EH [Switch] Selects the way Source View accesses the DOS command interpreter. If this switch is off, Source View will load a second copy of COMMAND.COM and let it executes the DOS command. This is the conventional way to execute a DOS command from a running program. If this switch is on, Source View will pass the DOS command directly to the original copy of COMMAND.COM via interrupt 2EH. This is so called the "thirty way" of executing a DOS command. Its benefits are: more memory efficient, faster execution, and being able to change global environment variables. Its disadvantage is that future version of DOS or third party command interpreter may not support Interrupt 2EH. If you are running Norton DOS Command Interpreter NDOS (Norton Utilities 6.01), you have to run a second program called NDOS2E in order to work with this switch being turned on. NDOS alone does not support Interrupt 2EH. Interrupt 2EH is still supported by MS-DOS up to version 6.0, but it is NOT supported by any versions of OS/2. Therefore, if you are running Source View under OS/2, make sure to turn this switch off. This switch affects the following functions: Dir, Copy, Del, Rename, and Command in the File Menu, and all batch files executed from Source View. ˛ VGA 132 Mode(Dec) [Number] Video BIOS mode number for 132 column mode. Refer to your video adapter's document for the correct number. Notice that this number must be in decimal while most documents use hexadecimal for video mode. ˛ Default Compiler [String] Default command line to execute the "Compile" function in the Compile Menu. ˛ Default Batch [String] Default command line to execute the "Batch" function in the Compile Menu. ˛ Default Run File [String] Default command line to execute the "Run" function in the Compile Menu. ˇ Editor Setup Menu ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ˛ Normal Text Color [Color] Display color for normal text in the editing screen. ˛ Block Text Color [Color] Display color for the active text block in the editing screen. ˛ Status Line Color [Color] Display color for the status line at the top of each opened file. ˛ Prompt Line Color [Color] Display color for the prompt line at the bottom of the editing screen. ˛ Backup Source Files [Switch] Turns on/off the file backup feature when saving a file. ˛ Insert Mode [Switch] Turns on/off the default Insert Mode. ˛ Indent Mode [Switch] Turns on/off the default Indent Mode. ˛ Tab Mode [Switch] Turns on/off the default Tab Mode. ˛ Trim Mode [Switch] Turns on/off the default Trim Mode. ˛ Wrap Mode [Switch] Turns on/off the default Wrap Mode. ˛ Auto-wrap Right [Number] Default Auto-wrap Right Margin. ˛ Auto-wrap Left [Number] Default Auto-wrap Left Margin. ˛ Window Format(0-5) [Number] Default Window Format for multiple file display. See the Window Format [Ctrl J F] function for details. ˛ Non-text Characters [String] Default Non-text Characters set used by functions such as: Move Left/Right One Word, Delete Left/Right One Word, Find/Replace, Auto-wrap, and Format Line. ˛ Dummy File Name [String] Dummy file name used when no files are loaded into the Source View Editor. ˛ Default Extension [String] Default extension used when no extension is specified while opening a file. Do not include a leading period for the extension. ˇ Key Map Setup Menu ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ This menu assigns user defined function keys to all editing functions. Use the arrow keys to select an editing function from one of the eight categories. Press the Enter key and then the desired function key that you want to assign to that function. If the key has already been assigned to another function, an error message is displayed. To remove a key assignment, press the Space Bar. ˇ Load ÕÕÕÕ Loads a Source View setup file. The default setup file is SV.CFG in current directory. At program start-up, Source View always tries to load a setup file in current directory. If no setup file is found, it will attempt the directory from which Source View was executed. ˇ Save ÕÕÕÕ Saves current Source View setup to a file. The default setup file is SV.CFG in current directory. If the file already exists, it will be renamed to its backup format before a new one is created. ˇ Build ÕÕÕÕÕ Creates a DOS executable file along with current Source View setup. The default file is SV.COM in current directory. If the file already exists, it will be renamed to its backup format before a new one is created. It is recommended that you save an original copy of the SV.COM file. You can also name the new file differently but make sure that its extension is ".COM". No matter what name you use, Source View always refers to its setup file and help file as SV.CFG and SV.HLP respectively.